Inside Macintosh: Programming With JManager /

Chapter 2 - JManager Reference / JManager Constants and Data Types

The Applet Locator

The Applet Locator Information Block

If you are synchronously creating an applet locator using the JMNewAppletLocatorFromInfo function, you must pass an information block that describes the location of the applet. This applet locator structure is defined by the JMLocatorInfoBlock data type.

struct JMLocatorInfoBlock {
   UInt32                 fVersion;   
   char*                  fBaseURL;   
   char*                  fAppletCode;
   short                  fWidth;     
   short                  fHeight;    
   int                    fOptionalParameterCount;
   JMLIBOptionalParams*   fParams;          
};

Field Description

fVersion

The version of JManager. You should set this field to kJMVersion.

fBaseURL

The URL of this applet's host page.

fAppletCode

The location of the applet's code (that is, the name of the class file that contains the code) as described in an applet tag.

fWidth

The width of the applet, in pixels.

fHeight

The height of the applet, in pixels.

fOptionalParameterCount

The number of optional parameters.

fParams

A pointer to first element in the the array of optional parameters.

The fields fVersion, fBaseURL, fAppletCode, fWidth, and fHeight must be present and cannot be null values. The other fields are optional and can contain any parameters that need to be passed to the applet for execution. If there are no optional parameters, fOptionalParameterCount should be 0 and fParams should be null.

See the description of the JMNewAppletLocatorFromInfo function (page 70) for information on using this strucure.

For more information about the format of an applet tag, check the JavaSoft documentation available at the Web site

http://www.javasoft.com/